W07-2. Deployment - 실습 가이드
7주차 실습: Deployment 로 방명록 운영하기
- Deployment 로 방명록 Pod 3개를 띄우고, Pod 를 지워도 되살아나는 것을 본다.
replicas숫자만 바꿔 늘리고 줄인다.- v1(파랑) → v2(초록) 롤링 업데이트를 실시간으로 지켜본다.
- 없는 버전(v9)을 배포하는 실수를 하고, 롤백으로 되돌린다.
| 실습 | 내용 | 시간 |
|---|---|---|
| 1 | Deployment 만들기 | 7분 |
| 2 | 자가 치유 | 5분 |
| 3 | 라벨 실험: 관리 대상에서 빼기 | 4분 |
| 4 | 스케일링 | 5분 |
| 5 | 롤링 업데이트 v1 → v2 | 10분 |
| 6 | 실수 배포 (v9) | 5분 |
| 7 | 롤백 | 6분 |
| 8 | 정리 | 3분 |
실습 1. Deployment 만들기
1-1. deployment.yaml 작성
VS Code 로 k8s 폴더에 deployment.yaml 을 만듭니다. 내아이디 를 바꾸세요.
apiVersion: apps/v1
kind: Deployment
metadata:
name: guestbook
labels:
app: guestbook
annotations:
kubernetes.io/change-cause: "v1 최초 배포"
spec:
replicas: 3
selector:
matchLabels:
app: guestbook
template:
metadata:
labels:
app: guestbook
spec:
containers:
- name: web
image: 내아이디/guestbook:v1
ports:
- containerPort: 8000
6주차
pod.yaml의metadata와spec이template:아래로 들어간 모양입니다. 비교해 보세요.
1-2. 적용하고 완료될 때까지 기다리기
kubectl apply -f deployment.yaml
kubectl rollout status deployment/guestbook
출력 예시:
deployment.apps/guestbook created
Waiting for deployment "guestbook" rollout to finish: 0 of 3 updated replicas are available...
Waiting for deployment "guestbook" rollout to finish: 1 of 3 updated replicas are available...
Waiting for deployment "guestbook" rollout to finish: 2 of 3 updated replicas are available...
deployment "guestbook" successfully rolled out
1-3. 세 단계 관계 확인
kubectl get deployments
kubectl get replicasets
kubectl get pods -o wide
출력 예시:
NAME READY UP-TO-DATE AVAILABLE AGE
guestbook 3/3 3 3 7s
NAME DESIRED CURRENT READY AGE
guestbook-6694d9fcc5 3 3 3 7s
NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES
guestbook-6694d9fcc5-75h8t 1/1 Running 0 7s 10.244.2.7 desktop-worker <none> <none>
guestbook-6694d9fcc5-d4rdk 1/1 Running 0 7s 10.244.2.6 desktop-worker <none> <none>
guestbook-6694d9fcc5-mnt7q 1/1 Running 0 7s 10.244.1.2 desktop-worker2 <none> <none>
- Deployment 1개 → ReplicaSet 1개(
guestbook-6694d9fcc5) → Pod 3개 - Pod 이름 = Deployment 이름 + ReplicaSet 번호 + Pod 번호
- NODE 열: Pod 가
desktop-worker,desktop-worker2에 나뉘어 배치됐습니다. scheduler 가 Worker Node 들에 골고루 나눈 것입니다. (Control Plane 노드에는 앱 Pod 를 두지 않습니다.) - 노드를 2개로 만들었다면 Worker 가 1개라서 모두 같은 노드에 놓입니다.
1-4. 브라우저로 확인
kubectl port-forward deployment/guestbook 8080:8000
http://localhost:8080 → 파란 방명록 v1. HOSTNAME 에 Pod 이름이 보입니다.
port-forward 는 Pod 3개 중 하나에만 연결하는 테스트용 통로입니다. 3개로 나눠 보내는 것은 8주차 Service 가 합니다.
확인했으면 Ctrl + C 로 끊습니다.
실습 2. 자가 치유
터미널 2를 열고, 같은 폴더에서 Pod 를 계속 지켜봅니다.
kubectl get pods -w
터미널 1에서 Pod 하나를 지웁니다. 이름은 kubectl get pods 로 보고 하나를 골라 넣으세요.
kubectl delete pod guestbook-6694d9fcc5-8f9bh
터미널 2 출력 예시: 지운 Pod 가 Terminating 되는 동시에 새 Pod 가 생깁니다.
guestbook-6694d9fcc5-8f9bh 1/1 Terminating 0 2m
guestbook-6694d9fcc5-2lbmz 0/1 Pending 0 0s
guestbook-6694d9fcc5-2lbmz 0/1 ContainerCreating 0 0s
guestbook-6694d9fcc5-2lbmz 1/1 Running 0 1s
이번에는 3개를 한꺼번에 지워 봅니다. -l 은 라벨로 고르는 옵션입니다.
kubectl delete pods -l app=guestbook
kubectl get pods
출력 예시: 몇 초 뒤 새 이름의 Pod 3개가 Running 입니다.
NAME READY STATUS RESTARTS AGE
guestbook-6694d9fcc5-7fqvb 1/1 Running 0 6s
guestbook-6694d9fcc5-8kqk4 1/1 Running 0 6s
guestbook-6694d9fcc5-lftb5 1/1 Running 0 6s
6주차에는 Pod 를 지우면 그대로 사라졌습니다. 지금은 ReplicaSet 이 "3개 유지" 를 책임지고 즉시 다시 만듭니다.
실습 3. 라벨 실험: 관리 대상에서 빼기
Pod 하나의 라벨을 app=debug 로 바꿉니다. 이름은 내 Pod 중 하나로 바꿔 넣으세요.
kubectl label pod guestbook-6694d9fcc5-7fqvb app=debug --overwrite
kubectl get pods -L app
출력 예시: -L app 은 app 라벨 값을 열로 보여 줍니다.
NAME READY STATUS RESTARTS AGE APP
guestbook-6694d9fcc5-7fqvb 1/1 Running 0 50s debug
guestbook-6694d9fcc5-8kqk4 1/1 Running 0 49s guestbook
guestbook-6694d9fcc5-kbpmc 1/1 Running 0 5s guestbook
guestbook-6694d9fcc5-lftb5 1/1 Running 0 51s guestbook
ReplicaSet 은 app=guestbook 라벨로 Pod 를 셉니다. 라벨을 바꾼 Pod 는 "내 것이 아니다" 가 되어 2개로 세고, 새로 1개를 만들었습니다.
라벨을 바꾼 Pod 는 지워지지 않고 관리 밖에서 그대로 돕니다. 문제가 생긴 Pod 를 서비스에서 떼어 내 조사용으로 남길 때 쓰는 요령입니다.
관리 밖으로 빠진 Pod 는 직접 지웁니다.
kubectl delete pod guestbook-6694d9fcc5-7fqvb
실습 4. 스케일링
4-1. 선언형: 파일을 고쳐서
deployment.yaml 의 replicas: 3 을 replicas: 5 로 바꾸고 저장합니다.
kubectl apply -f deployment.yaml
kubectl get pods
→ Pod 가 5개가 됩니다.
4-2. 명령형: 급할 때
kubectl scale deployment guestbook --replicas=2
kubectl get pods
→ 2개로 줄어듭니다. 줄일 때는 남는 Pod 를 골라 정상 종료(Terminating) 시킵니다.
4-3. 파일 기준으로 되돌리기
deployment.yaml 을 다시 replicas: 3 으로 고치고 저장합니다.
kubectl apply -f deployment.yaml
kubectl get deployment guestbook
출력 예시:
NAME READY UP-TO-DATE AVAILABLE AGE
guestbook 3/3 3 3 5m
kubectl scale 로 2개로 줄여도 파일에는 그대로 5가 적혀 있었습니다. 누군가 파일로 apply 하면 파일 값으로 돌아갑니다. 그래서 평소에는 파일을 고치는 방식을 씁니다.
실습 5. 롤링 업데이트 v1 → v2
5-1. 지켜볼 준비
터미널 2에서 지켜보던 명령이 꺼졌다면 다시 켭니다.
kubectl get pods -w
5-2. 파일 고치기
deployment.yaml 에서 두 곳을 바꿉니다.
annotations:
kubernetes.io/change-cause: "v2 배포 (초록)"
image: 내아이디/guestbook:v2
5-3. 적용
터미널 1:
kubectl apply -f deployment.yaml
kubectl rollout status deployment/guestbook
터미널 2 출력 예시: 새 ReplicaSet(5f994cddb4)의 Pod 가 하나 Running 이 될 때마다 옛 Pod(6694d9fcc5)가 하나씩 Terminating 됩니다.
guestbook-5f994cddb4-8q9lw 0/1 Pending 0 0s
guestbook-5f994cddb4-8q9lw 0/1 ContainerCreating 0 0s
guestbook-5f994cddb4-8q9lw 1/1 Running 0 1s
guestbook-6694d9fcc5-zlp58 1/1 Terminating 0 29s
guestbook-5f994cddb4-jmmpj 0/1 Pending 0 0s
guestbook-5f994cddb4-jmmpj 0/1 ContainerCreating 0 0s
guestbook-5f994cddb4-jmmpj 1/1 Running 0 0s
guestbook-6694d9fcc5-pwp8r 1/1 Terminating 0 29s
guestbook-5f994cddb4-w4sq9 0/1 Pending 0 0s
guestbook-5f994cddb4-w4sq9 0/1 ContainerCreating 0 0s
guestbook-5f994cddb4-w4sq9 1/1 Running 0 1s
guestbook-6694d9fcc5-2lbmz 1/1 Terminating 0 29s
1개 추가 → 준비되면 1개 종료 를 3번 반복했습니다. 그동안 Running 인 Pod 가 항상 3개 이상이었습니다. 이것이 무중단 배포입니다.
5-4. ReplicaSet 과 이력
kubectl get replicasets
kubectl rollout history deployment/guestbook
출력 예시:
NAME DESIRED CURRENT READY AGE
guestbook-5f994cddb4 3 3 3 30s
guestbook-6694d9fcc5 0 0 0 8m
deployment.apps/guestbook
REVISION CHANGE-CAUSE
1 v1 최초 배포
2 v2 배포 (초록)
옛 ReplicaSet(
6694d9fcc5)은 0개로 남아 있습니다. 롤백할 때 다시 씁니다.
5-5. 브라우저 확인
kubectl port-forward deployment/guestbook 8080:8000
http://localhost:8080 → 초록색 방명록 v2 🎉 확인 후 Ctrl + C.
실습 6. 실수 배포 (v9)
존재하지 않는 v9 를 배포하는 실수를 일부러 해 봅니다.
deployment.yaml 에서:
kubernetes.io/change-cause: "v9 배포 (실수)"
image: 내아이디/guestbook:v9
kubectl apply -f deployment.yaml
kubectl rollout status deployment/guestbook --timeout=30s
출력 예시: 끝나지 않고 30초 뒤 포기합니다.
Waiting for deployment "guestbook" rollout to finish: 1 out of 3 new replicas have been updated...
error: timed out waiting for the condition
kubectl get pods
kubectl get deployment guestbook
출력 예시:
NAME READY STATUS RESTARTS AGE
guestbook-5c96fffb47-p5pgw 0/1 ImagePullBackOff 0 30s
guestbook-5f994cddb4-c566p 1/1 Running 0 2m
guestbook-5f994cddb4-f89d9 1/1 Running 0 2m
guestbook-5f994cddb4-q74qh 1/1 Running 0 2m
NAME READY UP-TO-DATE AVAILABLE AGE
guestbook 3/3 1 3 10m
- 새 버전 Pod 1개만
ImagePullBackOff로 멈춰 있고, v2 Pod 3개는 그대로 Running 입니다. READY 3/3,AVAILABLE 3→ 사용자는 아무 문제 없이 v2 를 쓰고 있습니다.- 새 Pod 가 준비되지 않으면 옛 Pod 를 내리지 않는 롤링 업데이트의 안전장치 덕분입니다.
- STATUS 는
ErrImagePull과ImagePullBackOff가 번갈아 보일 수 있습니다.
실습 7. 롤백
7-1. 바로 되돌리기: rollout undo
kubectl rollout undo deployment/guestbook
출력 예시:
Warning: resource deployments/guestbook was previously managed with 'kubectl apply'. Rolling back will not update the kubectl.kubernetes.io/last-applied-configuration annotation, which may cause unexpected behavior on future 'kubectl apply' operations. Consider using 'kubectl apply' with your previous configuration file instead.
deployment.apps/guestbook rolled back
kubectl rollout status deployment/guestbook
kubectl get pods
kubectl rollout history deployment/guestbook
출력 예시:
deployment "guestbook" successfully rolled out
NAME READY STATUS RESTARTS AGE
guestbook-5f994cddb4-c566p 1/1 Running 0 3m
guestbook-5f994cddb4-f89d9 1/1 Running 0 3m
guestbook-5f994cddb4-q74qh 1/1 Running 0 3m
deployment.apps/guestbook
REVISION CHANGE-CAUSE
1 v1 최초 배포
3 v9 배포 (실수)
4 v2 배포 (초록)
- 실패한 v9 Pod 는 사라지고 v2 3개만 남았습니다.
- 이력에서 2번이 사라지고 4번(v2) 이 생겼습니다. 되돌리기도 새 배포 1건으로 기록됩니다.
7-2. 파일도 되돌리기 (중요!)
경고 메시지처럼, 내 deployment.yaml 에는 아직 v9 가 적혀 있습니다. 파일을 v2 로 되돌립니다.
kubernetes.io/change-cause: "v2 배포 (초록)"
image: 내아이디/guestbook:v2
kubectl apply -f deployment.yaml
kubectl get pods
kubectl rollout history deployment/guestbook
출력 예시:
deployment.apps/guestbook configured
NAME READY STATUS RESTARTS AGE
guestbook-5f994cddb4-7bl5l 1/1 Running 0 39s
guestbook-5f994cddb4-hf9t7 1/1 Running 0 41s
guestbook-5f994cddb4-j55xh 1/1 Running 0 40s
deployment.apps/guestbook
REVISION CHANGE-CAUSE
1 v1 최초 배포
3 v9 배포 (실수)
4 v2 배포 (초록)
configured가 나오지만 Pod 이름과 AGE 가 그대로입니다. 클러스터는 이미 v2 로 돌아가 있으므로 Pod 를 바꾸지 않고, "마지막으로 apply 한 파일 내용" 기록만 파일과 맞춘 것입니다. 이제 파일과 클러스터가 같은 상태(v2)입니다.
클러스터 상태와 파일 내용이 다르면 언젠가 사고가 납니다. 되돌릴 때도 파일을 고쳐서 apply 하는 습관을 들이세요.
실습 8. 정리
8주차에도 이 Deployment 를 그대로 씁니다. 지우지 않아도 됩니다.
노트북이 무거우면 지워도 됩니다(8주차 시작할 때 kubectl apply -f deployment.yaml 로 다시 만듭니다).
kubectl delete -f deployment.yaml
터미널 2 의
kubectl get pods -w는Ctrl + C로 끝냅니다.
자주 나는 문제와 해결
| 증상 | 원인 | 해결 |
|---|---|---|
`selector` does not match template `labels` |
selector.matchLabels 와 template.metadata.labels 가 다름 |
두 곳의 app: guestbook 을 똑같이 |
apply 했는데 아무 변화 없음 (unchanged) |
파일을 저장하지 않음 | VS Code 탭 이름 옆의 ● 표시(저장 안 됨) 확인 후 저장 |
rollout status 가 끝나지 않음 |
새 Pod 가 준비되지 않음 (이미지 오타 등) | kubectl get pods → 문제 Pod describe → 고치거나 rollout undo |
rollout history 의 CHANGE-CAUSE 가 <none> |
change-cause 애너테이션을 안 적음 |
metadata.annotations 에 적고 apply |
port-forward 가 unable to listen on any of the requested ports |
8080 을 다른 것이 사용 중 (이전 port-forward 가 안 꺼짐 등) | 다른 터미널의 port-forward 를 Ctrl + C, 또는 8081:8000 사용 |
kubectl delete pod 이름 에서 NotFound |
이름 오타, 또는 이미 새 이름으로 바뀜 | kubectl get pods 로 현재 이름 확인 (Pod 이름은 다시 만들어질 때마다 바뀜) |
오늘 쓴 명령어 정리
| 명령어 | 하는 일 |
|---|---|
kubectl apply -f deployment.yaml |
Deployment 만들기 / 바꾸기 |
kubectl rollout status deployment/이름 [--timeout=30s] |
배포 완료까지 기다리기 |
kubectl get deployments / replicasets / pods |
세 단계 확인 |
kubectl get pods -w |
실시간으로 지켜보기 |
kubectl get pods -L app |
라벨 값을 열로 보기 |
kubectl delete pods -l app=guestbook |
라벨로 골라 지우기 |
kubectl label pod 이름 키=값 --overwrite |
라벨 바꾸기 |
kubectl scale deployment 이름 --replicas=N |
개수 바꾸기 (명령형) |
kubectl port-forward deployment/이름 8080:8000 |
Deployment 의 Pod 하나로 테스트 연결 |
kubectl rollout history deployment/이름 |
배포 이력 |
kubectl rollout undo deployment/이름 [--to-revision=N] |
롤백 |
복습 과제
확인 퀴즈
- Deployment, ReplicaSet, Pod 는 각각 무엇을 책임지나요?
- Pod 3개를 한꺼번에 지웠는데 몇 초 뒤 다시 3개가 됐습니다. 누가, 어떤 기준으로 다시 만들었나요?
- Pod 하나의 라벨을
app=debug로 바꿨더니 Pod 가 4개가 됐습니다. 이유는? - 롤링 업데이트 중에 서비스가 끊기지 않는 이유는?
- v9 처럼 없는 이미지를 배포했을 때 사용자에게 영향이 없었던 이유는?
kubectl rollout undo후에 꼭 해야 할 일은?
- Deployment 는 버전(업데이트 방식·이력·롤백), ReplicaSet 은 개수 유지, Pod 는 실제 컨테이너 실행을 책임집니다.
- ReplicaSet 이
app=guestbook라벨이 붙은 Pod 를 세서 원하는 개수(3)보다 모자라니 새로 만들었습니다. - ReplicaSet 이 라벨로 Pod 를 세기 때문에, 라벨을 바꾼 Pod 는 "내 것이 아님" 이 되어 2개로 세고 1개를 새로 만들었습니다. 라벨을 바꾼 Pod 는 관리 밖에서 그대로 남습니다.
- 새 Pod 를 하나 추가하고 준비되면 옛 Pod 를 하나 내리는 방식으로 조금씩 바꾸기 때문에, 항상 서비스 가능한 Pod 가 있습니다.
- 새 Pod 가 준비(Ready)되지 않으면 옛 Pod 를 내리지 않기 때문에, 기존 v2 Pod 3개가 계속 서비스했습니다.
- 내 YAML 파일도 되돌린 버전으로 고쳐 두는 것입니다. 그러지 않으면 다음
apply때 잘못된 버전이 다시 배포됩니다.
도전 과제 (선택)
deployment.yaml의spec:아래(replicas와 같은 칸)에 아래를 추가하고, v1 ↔ v2 를 바꿔 가며kubectl get pods -w로 교체 순서가 어떻게 달라지는지 보세요.
(strategy: type: RollingUpdate rollingUpdate: maxSurge: 3 maxUnavailable: 0maxSurge: 3이면 새 버전 3개를 한꺼번에 띄운 뒤 옛 버전을 내립니다.)kubectl rollout undo deployment/guestbook --to-revision=1로 맨 처음 v1 으로 돌아가 보세요. 그다음 파일도 v1 으로 맞춰 apply 합니다.kubectl rollout restart deployment/guestbook은 무엇을 할까요? 실행하고 Pod 이름과 AGE 를 보세요. (이미지는 그대로, Pod 만 모두 새로 교체합니다. 설정을 다시 읽게 할 때 씁니다.)
지금은 port-forward 로 Pod 하나에만 접속했습니다. 다음 주에는 Pod 3개 앞에 Service 를 두어 하나의 주소로 나눠 받고, Gateway API 로 guestbook.localhost 같은 도메인 주소로 외부에 공개합니다.
네비게이션
| 이전 | 목록 | 다음 |
|---|---|---|
| ◀ 7주차 강의 노트 | 목록으로 | 8주차 강의 노트 ▶ |